home *** CD-ROM | disk | FTP | other *** search
/ Aminet 41 / Aminet 41 (2001)(Schatztruhe)[!][Feb 2001].iso / Aminet / comm / net / tf02.lha / TinyFugue / docs / tf-cat.man < prev    next >
Text File  |  1995-08-29  |  13KB  |  397 lines
  1.  
  2.  
  3.  
  4.      TTTTFFFF((((1111))))                 UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((LLLLOOOOCCCCAAAALLLL))))                 TTTTFFFF((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           tf - TinyFugue, a MUD client
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ttttffff [[[[----ffff_f_i_l_e]]]] [[[[----llllnnnnqqqq]]]] [[[[_w_o_r_l_d]]]]
  13.           ttttffff [[[[----ffff_f_i_l_e]]]] _h_o_s_t _p_o_r_t
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.           _T_i_n_y_F_u_g_u_e (also known as "Fugue" or "TF") is a line-based
  17.           client designed for connecting to MUD servers (note: LP,
  18.           DIKU, and other servers which use prompts require "/lp on";
  19.           see /help prompts).  TinyFugue runs on UNIX-like systems,
  20.           and on OS/2.
  21.  
  22.           Most of the _T_F documentation is in the help file, which may
  23.           be read online with the "/help" command.  This manual page
  24.           may be obsolete in certain areas; however, the helpfile will
  25.           always be up to date.
  26.  
  27.           _T_i_n_y_F_u_g_u_e is larger than most MUD clients, but has many more
  28.           features and is much more flexible.  The goal is to provide
  29.           the most functionality in a client that still maintains the
  30.           user-friendliness of _T_i_n_y_t_a_l_k.  Clients with extension
  31.           languages such as _T_c_l_t_t or _V_a_p_o_r_T_a_l_k can do a little more in
  32.           certain areas, but are considerably harder to use and learn.
  33.           _T_F provides most of these abilities in such a manner that
  34.           learning to use any one function is relatively easy.
  35.  
  36.           Because I am continually adding new features and changing
  37.           the code, _T_F sometimes becomes less stable in a new release.
  38.           Versions labled "alpha" are generally not as well tested as
  39.           "beta" versions, so they have the potential for more bugs.
  40.           For this reason, I leave some older versions at the ftp site
  41.           where I distribute _T_F (ftp.tcp.com), which do not have all
  42.           the current features but may have fewer bugs than the most
  43.           recent release.
  44.  
  45.  
  46.      CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  47.           With no arguments, _T_F will try to connect to the first world
  48.           defined in the configuration file(s).
  49.  
  50.           With a wwwwoooorrrrlllldddd argument, _T_F will try to connect to wwwwoooorrrrlllldddd, as
  51.           defined in the configuration file.  If wwwwoooorrrrlllldddd is omitted, it
  52.           will try to connect to the first world defined in your
  53.           configuration files.
  54.  
  55.           With hhhhoooosssstttt and ppppoooorrrrtttt arguments, _T_F will define a temporary
  56.           world and try to connect to it.  The hhhhoooosssstttt may be an IP
  57.           number or regular name format.
  58.  
  59.           OPTIONS
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 1/23/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      TTTTFFFF((((1111))))                 UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((LLLLOOOOCCCCAAAALLLL))))                 TTTTFFFF((((1111))))
  71.  
  72.  
  73.  
  74.           -f_f_i_l_e
  75.                Load _f_i_l_e instead of $HOME/.tfrc or $HOME/tfrc at
  76.                startup.
  77.  
  78.           -f   Do not load any personal configuration file.  The
  79.                library will still be loaded.
  80.  
  81.           -l   Disable automatic login.
  82.  
  83.           -n   Do not connect to any world at startup.
  84.  
  85.           -q   Quiet login (overrides %{quiet} flag).
  86.  
  87.  
  88.      FFFFEEEEAAAATTTTUUUURRRREEEESSSS
  89.           Among other things, _T_F allows you to:
  90.  
  91.           Divide the screen into two parts, for input and output, with
  92.           flexible handling of input (/visual mode).
  93.  
  94.           Connect to multiple worlds and switch between them.
  95.  
  96.           Wrap MUD output at the edge of the screen.
  97.  
  98.           Edit text in the input buffer.
  99.  
  100.           Recall previous commands.
  101.  
  102.           Modify key sequences used to perform editing functions.
  103.  
  104.           Bind commands to key sequences.
  105.  
  106.           Define complex macros to perform MUD tasks easily.
  107.  
  108.           Create triggers which automatically perform certain tasks
  109.           when certain output is received from the MUD.
  110.  
  111.           Modify existing macros using either a command format or
  112.           interactive editing.
  113.  
  114.           Support "portals" that automatically switch from world to
  115.           world.
  116.  
  117.           Hilite or color all or part of a line that matches a certain
  118.           pattern.
  119.  
  120.           Gag lines that match certain patterns.
  121.  
  122.           Suppress frequently repeated text ("spamming").
  123.  
  124.           Automatically log into a character on a world.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 1/23/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      TTTTFFFF((((1111))))                 UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((LLLLOOOOCCCCAAAALLLL))))                 TTTTFFFF((((1111))))
  137.  
  138.  
  139.  
  140.           Send a text file to the MUD in flexible ways, or echo it
  141.           locally.
  142.  
  143.           Send the output of a system command to the MUD, or echo it
  144.           locally.
  145.  
  146.           Send text previously received from the MUD to the MUD, or
  147.           echo it locally.
  148.  
  149.           Repeat a MUD or _T_F command a number of times.
  150.  
  151.           Do the above four things at varying intervals, or at a
  152.           rapid-fire rate.
  153.  
  154.           Log a session to a file.
  155.  
  156.           Separate LP and Diku style prompts from normal output.
  157.  
  158.           Page output using a --More-- prompt.
  159.  
  160.           Recall previously received text.
  161.  
  162.  
  163.      CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEESSSS
  164.           _T_F will attempt to read two files when starting.  The first
  165.           is a public configuration file "stdlib.tf", located in
  166.           TFLIBDIR.  TFLIBDIR is defined when _T_F is installed, and is
  167.           often /usr/local/lib/tf.lib, or under the home directory of
  168.           the installer.  This library contains many macros and
  169.           definitions essential to the correct operation of _T_F.
  170.  
  171.           Next, _T_F will attempt to read your personal configuration
  172.           file, $HOME/.tfrc or $HOME/tfrc, in which you can put any _T_F
  173.           commands you want executed automatically at startup.  Two of
  174.           the most useful commands to use in a _T_F configuration file
  175.           are /addworld and /load.
  176.  
  177.           For backward compatability, _T_F will also try to read the
  178.           _T_i_n_y_T_a_l_k configuration file.  Its name defautls to
  179.           $HOME/.tinytalk, or can be defined by the TINYTALK
  180.           environment variable.  This file may start with a List_ of
  181.           worlds that will be defined as if with /addworld.
  182.  
  183.  
  184.      HHHHIIIISSSSTTTTOOOORRRRYYYY
  185.           Anton Rang (Tarrant) in February of 1990 released _T_i_n_y_t_a_l_k,
  186.           the first Tinyclient with any great number of features,
  187.           including hiliting and suppression of text, simple triggers,
  188.           and separating input and output on the screen.  Leo Plotkin
  189.           (Grod) made rather extensive modifications to _T_i_n_y_t_a_l_k to
  190.           produce _T_i_n_y_w_a_r, which was plagued with some serious bugs
  191.           and was never officially released (the phrase "Tinywar
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 1/23/95)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      TTTTFFFF((((1111))))                 UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((LLLLOOOOCCCCAAAALLLL))))                 TTTTFFFF((((1111))))
  203.  
  204.  
  205.  
  206.           doesn't exist" is often quoted), and is now an unsupported
  207.           client.  _T_F began when Greg Hudson (Explorer_Bob) merged
  208.           many of the new features of _T_i_n_y_w_a_r back into _T_i_n_y_T_a_l_k, and
  209.           added many new features of his own, most notably the split
  210.           screen.  Some of the code in Greg's releases was contributed
  211.           by Leo Plotkin.  After Greg moved on to _V_a_p_o_r_T_a_l_k, Ken Keys
  212.           (Hawkeye) took over design and maintenance of _T_F in July
  213.           1991, and continues to make improvements in features and
  214.           performance.
  215.  
  216.           The code size of _T_F has surpassed 300K (unstripped), and is
  217.           signifigantly larger than _T_i_n_y_t_a_l_k.  It is, in fact, more
  218.           than three times the size of a number of existing servers.
  219.           As of version 3.0, it has 66 builtin commands and 57 library
  220.           commands, each documented in the helpfile.
  221.  
  222.           It has been stated that _T_F is the most-used client in MUDdom
  223.           at the current time.  I haven't taken a poll, but I wouldn't
  224.           be surprised.
  225.  
  226.  
  227.      RRRREEEEVVVVIIIIEEEEWWWWSSSS
  228.           _T_F has significantly changed the tinyclient world.  It has a
  229.           number of merits and a number of flaws, and has frequently
  230.           been criticized (mostly out of boredom; nobody takes this
  231.           business too seriously) as having too many features and
  232.           being too damn big.
  233.  
  234.                "Tinywar doesn't exist; TinyFugue merely shouldn't."
  235.           -- Coined by Woodlock, I believe.
  236.  
  237.                "TinyFugue is a work of art."  -- Binder, obviously
  238.           after having too much to drink.
  239.  
  240.                "TinyFugue is the biggest hack since the platform it
  241.           was built on."  -- Explorer_Bob, in one of his lucid
  242.           moments.
  243.  
  244.           The New York Times, the Christian Science Monitor and the
  245.           Washington Post all refused to comment.
  246.  
  247.  
  248.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  249.           Copyright (C) 1993, 1994 Ken Keys
  250.  
  251.           _T_i_n_y_F_u_g_u_e (aka "_t_f") is protected under the terms of the GNU
  252.           General Public License.  See the file "COPYING" for details.
  253.  
  254.           _T_F is currently supported by Ken Keys, who may be contacted
  255.           by e-mail at kkeys@ucsd.edu or hawkeye@tcp.com.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 1/23/95)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      TTTTFFFF((((1111))))                 UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((LLLLOOOOCCCCAAAALLLL))))                 TTTTFFFF((((1111))))
  269.  
  270.  
  271.  
  272.      BBBBAAAACCCCKKKKWWWWAAAARRRRDDDD IIIINNNNCCCCOOOOMMMMPPPPAAAATTTTIIIIBBBBIIIILLLLTTTTIIIIEEEESSSS
  273.           VERSION 3.2
  274.  
  275.           /rand has been replaced with rand().  Color names can no
  276.           longer be user defined (but color codes still can).  The "="
  277.           operator does comparison, not assignment.
  278.  
  279.           VERSION 3.1
  280.  
  281.           Added type argument to WORLD and LOGIN hooks.
  282.  
  283.           VERSION 3.0
  284.  
  285.           Backslashes in macros are interpreted slightly differently
  286.           than in previous versions.  Turning on the "backslash" flag
  287.           will enable the old behavior.
  288.  
  289.           VERSION 2.1
  290.  
  291.           The CONNECT hook is now called before the LOGIN hook.  In
  292.           2.0, CONNECT was called after autologin.
  293.  
  294.           VERSION 2.0
  295.  
  296.           In versions prior to 2.0, <space> was used to scroll the
  297.           pager; 2.0 uses <tab> as the default, to allow the pager to
  298.           be nonblocking.
  299.  
  300.           _T_i_n_y_t_a_l_k style name gags and hilites are no longer
  301.           supported.  You must use the '*' wildcard explicitly, as in
  302.           '/hilite hawkeye*'.
  303.  
  304.           _T_i_n_y_t_a_l_k style page and whisper hilites are no longer
  305.           supported.  However, /hilite_page and /hilite_whisper macros
  306.           are provided in the default macro library.
  307.  
  308.           The .tinytalk file may not be supported in the future; use
  309.           .tfrc instead.
  310.  
  311.           The '-' command line option in versions prior to 2.0 is no
  312.           longer supported, and has been replaced with '-l'.
  313.  
  314.  
  315.      BBBBUUUUGGGGSSSS
  316.           When unterbamfing, the old connection should not be closed
  317.           until the new connection succeeds.
  318.  
  319.           If a shell quote (/quote !) reads a partial line from the
  320.           pipe, the read will block until the rest of the line is
  321.           read.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 1/23/95)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      TTTTFFFF((((1111))))                 UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((LLLLOOOOCCCCAAAALLLL))))                 TTTTFFFF((((1111))))
  335.  
  336.  
  337.  
  338.      WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  339.           The Surgeon General has determined that MUDding can be
  340.           detrimental to your GPA.
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 1/23/95)
  394.  
  395.  
  396.  
  397.